home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / DESQVIEW / DVSPAWN.ARJ / SPAWN.DOC < prev   
Text File  |  1992-01-25  |  5KB  |  127 lines
  1.  
  2.                                    SPAWN 1.0
  3.  
  4.                                         by Gary Chanson
  5.                                             (C) 1991
  6.  
  7.  
  8.         SPAWN  is  Copyright 1991  by Gary Chanson  and  Starquest
  9.         Systems.  No restrictions are placed on the non-commercial
  10.         use of this program.   This program  and its documentation
  11.         may be copied  and re-distributed  provided that they  are
  12.         not changed  and no fee is charged for them.  An exception
  13.         is granted  to  not-for-profit  user's  groups,  which are
  14.         authorized  to charge  a nominal  fee  for  materials  and
  15.         handling.  Another  exception is granted  specifically for
  16.         Compuserve.
  17.  
  18.  
  19.     Description:
  20.  
  21.             SPAWN is a  DESQview (tm)  specific utility  which invokes
  22.         DESQview  tasks  from  a  command  line.  DESQview  tasks  are
  23.         defined  in  Program Information Files   which  normally  have
  24.         ".DVP"  as  their  extension.  SPAWN loads  the DVP file  into
  25.         memory  and can  optionally  modify  it before  passing  it to
  26.         DESQview for execution.  Once the  modified DVP data structure
  27.         has been  passed to  DESQview,  SPAWN  terminates  and returns
  28.         control to  the batch file  or command processor  which called
  29.         it.  The spawned program continues  to run as a new task under
  30.         DESQview's multitasking.
  31.  
  32.  
  33.     Usage:
  34.  
  35.         SPAWN [options] filename[.ext] [options] [-Ccmnd] [[@]tail]
  36.  
  37.                 (parameters in brackets are not required)
  38.  
  39.             The only  required  parameter  is the  name  of a  Program
  40.         Information  File.  The default extension  is `.DVP'.  Options
  41.         must be preceded by either `/' or `-'  and may be in any order
  42.         with the exception of the -C option.  All options following -C
  43.         are assumed to be  part of the command tale  and to be options
  44.         for the  spawned  program.  The first  blank delimited  string
  45.         after the DVP filename which is not an option is assumed to be
  46.         the start of the command tail.   Any options following it will
  47.         also be passed to the spawned program.
  48.  
  49.             Since several long strings  may be required as part of the
  50.         SPAWN command line, a temporary file  may be used to pass part
  51.         of the command tail.  The DVP filename  must be passed as part
  52.         of the command line.  The command tail for the spawned program
  53.         may be  passed as part  of the command line  or in a temporary
  54.         file,  but  may not  be split  between  both.  Options  may be
  55.         passed in both the command line  and a temporary file provided
  56.         that the  -C option  is not passed  on the  command line.  The
  57.         temporary filename  must be the last parameter  on the command
  58.         line and be prefaced by `@'.
  59.  
  60.             SPAWN  recognizes  three  pseudo-drives  for all  filename
  61.         inputs.  SPAWN will substitute the appropriate string for each
  62.         pseudo-drive  and use it in modifying  the DVP data structure.
  63.         Pseudo-drives  can also  be used  in specifying  the DVP file.
  64.  
  65.             @:  current default path
  66.             *:  path of SPAWN.COM
  67.             $:  path from environment variable `TEMP='
  68.  
  69.  
  70.     Options:
  71.  
  72.         -B
  73.             Start task in background.
  74.  
  75.         -C<command>
  76.             Command to be executed.
  77.  
  78.         -H
  79.             Run task hidden.  This task cannot be made visible.
  80.  
  81.         -K<xx>
  82.             Open menu (and script) key.  This two character code is
  83.             used to find any linked script files.
  84.  
  85.         -M<n>
  86.             Required memory in kilobytes.  If this amount of memory is
  87.             not available, DESQview will display an error message and
  88.             refuse to spawn the task.
  89.  
  90.         -O<y or n>
  91.             Use own colors.
  92.  
  93.         -P<path>
  94.             Startup path.
  95.  
  96.         -R<n>
  97.             Requested maximum memory in kilobytes.  DESQview will
  98.             allocate as much memory to this task as it can up to this
  99.             amount.
  100.  
  101.         -T<string>
  102.             Window title.  Spaces may be embedded in the title string
  103.             by replacing them with `\S'.
  104.  
  105.         -W<x,y,wide,long>
  106.             Window starting size and position.
  107.  
  108.         -X<y a or n>
  109.             Close on exit.
  110.  
  111.         -?
  112.             Help!
  113.  
  114.  
  115.     -----------------------------------------------------------------------
  116.  
  117.             Please forward all comments and bug reports to:
  118.  
  119.                 Gary Chanson
  120.  
  121.                 360 Waltham Street
  122.                 West Newton, MA  USA  02165-1732
  123.  
  124.                 Voice:  617-527-7206
  125.  
  126.                 Email:  BCS-IBM BBS - 617-332-5584
  127.